パワーオフ状態のVMを表示するためのREST APIの使用

リソースモデル

パワーオフ状態のVMを表示するためのREST APIは、次のレベルで呼び出すことができます。

すべてのドメイン
vCenter
データセンター
ホスト
データセンター > クラスター
データセンター > ホスト
データセンター > クラスター > ホスト

リソース情報

応答形式

JSON

リクエストヘッダー要件

Content-Type: application/json

Authorization:Basic <Base 64でエンコードされたユーザー名:パスワード> (オプション。LDAPが有効になっている場合にのみ必須)

サポートされるリクエストメソッド

POST

リソースURL

パワーオフ状態のVMに関する情報を取得するためのベースURLは次のとおりです。

https://<IPアドレスまたはホスト名>:<ポート番号>/PV/api/v1

この例では、

<IPアドレス> または <ホスト名> はHP vPVサーバーのIPアドレスまたはホスト名です。
<ポート番号> はHP vPVサーバーのポート番号です。デフォルトのポート番号は8444です。

ベースURLには、環境内のパワーオフ状態のVMに関する情報を取得するための適切なURIを追加する必要があります。次の表に、REST APIのURLの詳細を示します。

API	URL
仮想化環境にあるすべてのパワーオフ状態のVMの詳細を表示するには	`https://<IPアドレス>:<ポート番号>/PV/api/v1/poweredoffvmlist`
特定のデータセンターにあるパワーオフ状態のVMの詳細を表示するには	`https://<IPアドレス>:<ポート番号>/PV/api/v1/datacenter/<データセンターID>/poweredoffvmlist` この例では、 `<データセンターID>` はデータセンターのIDです。
データセンター内の特定のホストにあるパワーオフ状態のVMの詳細を表示するには	`https://<IPアドレス>:<ポート番号>/PV/api/v1/datacenter/<データセンターID>/host/<ホストID>/poweredoffvmlist` この例では、 `<データセンターID>` はデータセンターのIDです。 `<ホストID>` はホストのIDです。
データセンター内の特定のクラスターにあるパワーオフ状態のVMの詳細を表示するには	`https://<IPアドレス>:<ポート番号>/PV/api/v1/datacenter/<データセンターID>/cluster/<クラスターID>/host/<ホストID>/poweredoffvmlist` この例では、 `<データセンターID>` はデータセンターのIDです。 `<ホストID>` はホストのIDです。 `<クラスターID>` はクラスターのIDです。
データセンター内のクラスターに属する特定のホストにあるパワーオフ状態のVMの詳細を表示するには	`https://<IPアドレス>:<ポート番号>/PV/api/v1/datacenter/<データセンターID>/cluster/<クラスターID>/poweredoffvmlist` この例では、 `<データセンターID>` はデータセンターのIDです。 `<クラスターID>` はクラスターのIDです。
特定のホストにあるパワーオフ状態のVMの詳細を表示するには	`https://<IPアドレス>:<ポート番号>/PV/api/v1/host/<ホストID>/poweredoffvmlist` この例では、 `<ホストID>` はホストのIDです。
環境内のすべてのvCenterにあるパワーオフ状態のVMの詳細を表示するには	`https://<IPアドレス>:<ポート番号>/PV/api/v1/vcenters/poweredoffvmlist`

JSON応答

応答で次のJSONが返されます。

    "poweredoffcount" :n,

    "poweredoffList" :

[ {

       "systemName" :"vPV_361_16.184.40.70",

       "annotations" :"",

       "poweredOffSince" :1430980102,

       "downTimePercent" :100.0,

       "hostName" :"16.184.42.71",

       "diskUsed" :21092.0,

       "cpuutil" :0.0,

       "memutil" :0.0,

       "diskIO" :0.0,

       "netByte" :0.0,

},

       "systemName" :"RHEL-KVMHost-vm2",

       "annotations" :"",

       "poweredOffSince" :1430980102,

       "downTimePercent" :100.0,

       "hostName" :"16.184.42.71",

       "diskUsed" :230400.0,

       "cpuutil" :0.0,

       "memutil" :0.0,

       "diskIO" :0.0,

       "netByte" :0.0,

.

       "systemName" :"RHEL-KVMHost-vm3",

       "annotations" :"",

       "poweredOffSince" :1430980102,

       "downTimePercent" :100.0,

       "hostName" :"16.184.42.71",

       "diskUsed" :230400.0,

       "cpuutil" :0.0,

       "memutil" :0.0,

       "diskIO" :0.0,

       "netByte" :0.0,

}

} ]